home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / rts20.zip / RTS.DOC < prev    next >
Text File  |  1990-11-03  |  3KB  |  76 lines
  1.                                 RTS 2.0
  2.  
  3.                A program to toggle the RTS line in doors
  4.  
  5.                                   by
  6.                                Bob Eyer
  7.                              [73230,2620]
  8.  
  9.                               Nov 4, 1990
  10.  
  11.      Syntax:
  12.  
  13.      RTS [port]
  14.  
  15.      where  port  may  be either 1 or 2.  If port is not entered on the
  16.      commandline, or if any number other than 1 or 2  is  entered,  RTS
  17.      defaults port to 1.
  18.  
  19.      This  program  toggles  the  logic status of the RTS line, without
  20.      altering the DTR  line,  and  deals  directly  with  standard  IBM
  21.      hardware modem control registers for ports 1 or 2.   It  does  not
  22.      open  or  close the communications port.  RTS 2.0 may executed any
  23.      number  of times without sending invalid data to the modem control
  24.      register, and will not stay resident in memory.  Consequently, use
  25.      of this program  does  not  reduce  free  space  available  for  a
  26.      specific door program.
  27.  
  28.      If  RTS is low, this program will set it high; if high it will set
  29.      the level to low.  RTS will not provide any video output, as it is
  30.      designed to be invoked  from  a  batch  file  which  controls  the
  31.      processing of a specific door program - so that the remote user is
  32.      not  aware  of  its operation.  Therefore, the Sysop must use some
  33.      other indicator program to determine the actual status of the  RTS
  34.      line, such as RS232.COM - or the RS light on the host modem.
  35.  
  36.      General Discussion:
  37.      ------------------
  38.      Have  you  found a door program which, when accessed through shell
  39.      or exit doors of RBBS, simply hangs remote video?  This may be the
  40.      program which solves your problem.
  41.  
  42.      Most  door  programs  don't  have  RTS/CTS  problems when executed
  43.      through the shell or exit routines of RBBS.  This is  due  to  the
  44.      fact that most door programs, particularly those which are written
  45.      in  BASIC, will reopen the communications port in such a way as to
  46.      raise the RTS line.
  47.  
  48.      However,  some  host programs may, under certain conditions, lower
  49.      the RTS line when dropping to DOS for  a  door  application,  even
  50.      where DTR is unaffected.
  51.  
  52.      Setting the RTS line at logic low means that programs which reopen
  53.      the communications port without correcting this problem  will  not
  54.      send any information.  Typically, such programs will be written in
  55.      a  language, such as Pascal or C, which don't make any assumptions
  56.      about how the port should be opened; and some authors forget  that
  57.      not  all  host  programs allow doors to pick the RTS logic off the
  58.      host's settings.
  59.  
  60.      RTS  2.0  should solve this problem.  However, don't use it unless
  61.      you're sure you have an RTS logic problem: If  your  host  program
  62.      keeps RTS high after drop to DOS, using RTS 2.0 will force it low.
  63.  
  64.      DISCLAIMER:
  65.      ==========
  66.      This program is circulated as public domain without any  guarantee
  67.      or  warranty;  and  the  user, by downloading this program, or any
  68.      variant thereof or by receiving it or any of its versions  in  any
  69.      other  form, agrees to accept full responsibility for its use.  It
  70.      is therefore understood that the user accepts this program or  any
  71.      previous  version  as  is.
  72.  
  73.      ------------------------------------------------------------------
  74.      End of documentation.
  75.  
  76.